home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / opuslog.arc / OPUS!LOG.DOC next >
Encoding:
Text File  |  1987-08-10  |  30.8 KB  |  758 lines
  1.  
  2.  
  3.  
  4.                                Opus!Log
  5.  
  6.                         Version 2.00 (May,  1987)
  7.                         Version 2.2x (June, 1987)
  8.                         Version 2.3x (July, 1987)
  9.                         Version 2.4x (August, 1987)
  10.  
  11.  
  12.  
  13.  
  14.                 (c) Copyright 1987, Satore Center Software
  15.  
  16.                            All Rights Reserved
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                            User Documentation
  24.                            ------------------
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                        1.00 - IMPORTANT INFORMATION
  33.  
  34.  
  35. This product is militantly Public Domain.  You may not charge for the use
  36. or  distribution of this product in any manner whatsoever.   This product
  37. may  not be used in any commerical or profit-making enterprise.   It  may
  38. not be duplicated or modified in any way except for personal use.
  39.  
  40. There are no warranties stated or implied.  You use this product fully at
  41. your own risk without guarantee as to suitability of purpose.
  42.  
  43. You need not register to use this program.  It is free.    We do ask that
  44. you consider a contribution if you use the program regularly. Please send
  45. your contribution to:
  46.  
  47.                        Satore Center Software
  48.                          295 Ulloa Street
  49.                       San Francisco, CA  94127
  50.                         Data: (415) 753-3356
  51.  
  52. You  may send bug reports/suggestions to Satore Center by NetMail.    Our
  53. net  address is 161/521.   We make no assertions as to future versions or
  54. any guarantees as to program changes.  We will, however,  work upon known
  55. bugs and  consider  suggestions for improvements as time permits.  Should
  56. you  wish to send a bug report please also netmail the OPUS log  and  the
  57. output from Opus!Log so we can track the critter down.
  58.  
  59. Should you have any questions about the use of this program or the import
  60. of its copyright please contact Satore Center Software.
  61.  
  62. Note:  There are always last minute additions.  You will find several new
  63. enhancements to this version.  Enter OPUS!LOG for a full help screen.
  64.  
  65.                          2.00 - PROGRAM OVERVIEW
  66.  
  67.  
  68. Opus!Log  is a log file analysis system for use with the log  created  by
  69. OPUS(tm)  BBS software.    It has been tested with OPUS versions  through
  70. Gamma 1d (June, 1987). It is expected that users of Opus!Log will be OPUS
  71. Sysops.  Opus!Log will not work with log reports from other BBS systems.
  72.  
  73. The OPUS(tm) BBS system provides a wealth of log information,  especially
  74. when  the VERBOSE mode is selected in the OPUS(tm)  control file.   Human
  75. analysis of this information can be difficult,  however,  since all  OPUS
  76. log entries are in a linear (time relative)  format.  Opus!Log provides a
  77. multitude  of  ways  to "break out"  categories of  log  information  for
  78. analysis.    When run on a daily basis Opus!Log will provide a series  of
  79. summary  reports which will tell the Sysop at a glance what has  happened
  80. in the preceeding log period.
  81.  
  82. Opus!log provides three categories of reports.   The first category is  a
  83. series of FIXED FORMAT reports discussed in Section 3.00.   The second is
  84. a standard STATISTICAL report discussed in Section 4.00.  The  third   is
  85. a  user-definable series of reports discussed  in  Section 5.00.     User
  86. defined reports are unlimited both in terms of context and number.
  87.  
  88. Installation  of  Opus!Log  is discussed in Section 6.00   and  is  quite
  89. simple.  It is strongly recommended that you set your OPUS log output  to
  90. VERBOSE in your OPUS control file before using Opus!Log.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.                        3.00 - FIXED FORMAT REPORTS
  97.  
  98.  
  99. The  reports  which follow are all fixed format;  that is,   their  ouput
  100. cannot be changed by the  user.   They may be selected individually or in
  101. groups as discussed in Section 6.00.   Under default conditions  Opus!Log
  102. will  generate  all of these reports (for a discussion  of  the  Opus!Log
  103. default conditions see below).   Entering "OPUS!LOG"  without any command
  104. line  parameters  will display a list of the various options.    Entering
  105. "OPUS!LOG  -ALL"  will generate all fixed format reports as discussed  in
  106. Section 6.00.
  107.  
  108. The  reports which follow constitue a "basic"  series which will  provide
  109. all the information a Sysop would normally need regarding BBS activities.
  110.  
  111.  
  112.  
  113.  
  114.                3.01 - File Exchange Summary (Human Callers)
  115.  
  116.  
  117. This  report provides information on all transactions which  involve  the
  118. uploading   or  downloading of files by human callers.    If a  file  was
  119. moved  to or from your OPUS system by a user the result will be shown  in
  120. this report in the following format:
  121.  
  122.  
  123.  
  124.                              Opus!Log - Ver. 2.2xn
  125.                (C) Copyright 1987, Satore Center Software, [SCS]
  126. ------------------------------------------------------------------------------
  127.                   File Exchange Summary (Human Callers)
  128. ------------------------------------------------------------------------------
  129.   Date    Time                      Commentary or Description
  130.  
  131.  
  132. 11 MAY  7:25:39  DAVID COE CALLING
  133. 11 May  7:31:58  DL-Y c:\opusdate.arc                  Size =  -32,456
  134. 11 May  8:02:20  DL-Y c:\do-flyer.arc                  Size =  - 4,555
  135. 11 May  8:03:32  DL-Y c:\do-sysop.arc                  Size =  -12,456
  136.                           :                                    |
  137.                          etc.                                 etc.
  138.                           :                                    |
  139. ------------------------------------------------------------------------------
  140. Lines Scanned:  1092                                    End of Summary
  141. ==============================================================================
  142.  
  143.  
  144.  
  145.  
  146. If  a caller uploads a file,  that information will be printed  in  UPPER
  147. CASE.   In all instances the size of the file and the cumulative size  of
  148. the user's transactions will be displayed.
  149.  
  150. If  the command line switch -TF was used,  OPUS!LOG will also append  the
  151. filenames  to a file called OLOGLIST.TXT on the default  drive/directory.
  152. This  file is useful for determining file downloading/uploading and files
  153. which  are not active.   It is in standard ASCII format and suitable  for
  154. use by other utility programs.
  155.  
  156.  
  157.  
  158.                     3.02 - Human Caller Summary Report
  159.  
  160.  
  161. A straight forward summary of who called,  when they called and how  long
  162. they were online.  Here is an example:
  163.  
  164.  
  165.  
  166.  
  167.                              Opus!Log - Ver. 2.2xn
  168.                (C) Copyright 1987, Satore Center Software, [SCS]
  169. ------------------------------------------------------------------------------
  170.                               Human Caller Summary
  171. ------------------------------------------------------------------------------
  172.   Date    Time                      Commentary or Description
  173.  
  174. 11 May  6:20:13  Mike Kelleher              10   minutes online.
  175. 11 May  6:35:27  Lee Fields                 15   minutes online.
  176. 11 May  7:03:33  Mike Lennig                3    minutes online.
  177. 11 May  7:25:39  David Coe                  38   minutes online.
  178. 11 May  8:08:30  Justin Marquez             17   minutes online.
  179. 11 May  8:27:17  Rene Bilodeau              10   minutes online.
  180. 11 May  8:56:12  Bill Macneill              14   minutes online.
  181. 11 May  9:19:36  Geoffrey Meredith          2    minutes online.
  182.                       :
  183.                       :
  184.                      etc.
  185.                       :
  186.                       :
  187.                       :
  188. ------------------------------------------------------------------------------
  189. Lines Scanned:  1120                                    End of Summary
  190. ==============================================================================
  191.  
  192.  
  193.  
  194.  
  195.  
  196. This report is simple enough and requires no explanation.   At times  you
  197. may see a "--" in place of the number of minutes a user was online.  This
  198. is  normal  and simply means that OPUS has not recorded the  online  time
  199. data.
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                    3.03 - Outgoing Calls Summary Report
  206.  
  207.  
  208. Whenever OPUS makes an outgoing call for matrix purposes the details will
  209. be  recorded  in this report.   If a connection is made  and  traffic  is
  210. passed, that will also be recorded and identified with seperator lines.
  211.  
  212.  
  213.  
  214.  
  215.                              Opus!Log - Ver. 2.2xn
  216.                (C) Copyright 1987, Satore Center Software, [SCS]
  217. ------------------------------------------------------------------------------
  218.                              Outgoing Calls Summary
  219. ------------------------------------------------------------------------------
  220.   Date    Time                      Commentary or Description
  221.  
  222.  
  223. 11 May  7:20:18  Calling FOG CITY OPUS (222-3333)................. CONNECT ....
  224. 11 May  7:22:08  Flagging c:\002401ff.mo5 as sent                             :
  225. 11 May  7:22:20  Outgoing connect time: 1:37 (125/10)                         :
  226.                  ................................................... END .....:
  227.  
  228.  
  229. 11 May  9:34:10  Calling Mike's Place (333-4444).................. CONNECT ....
  230. 11 May  9:34:45  Bundle sent to 5210/2                                        :
  231. 11 May  9:34:51  Outgoing connect time: 0:14 (5210/2)                         :
  232.                  ................................................... END .....:
  233.  
  234.  
  235. 11 May 12:34:27  Calling FOG CITY OPUS (333-4444)................. CONNECT ....
  236. 11 May 12:36:16  Flagging c:\002401ff.mo6 as sent                             :
  237. 11 May 12:36:28  Outgoing connect time: 1:36 (125/10)                         :
  238.                  ................................................... END .....:
  239.  
  240.  
  241. 11 May 12:41:08  Calling Harv's Hideout (444-3333)................ CONNECT ....
  242. 11 May 12:41:45  Session with Harv's Hideout - San Francisco (0:161/77.0)     :
  243.                  ................................................... END .....:
  244.  
  245.  
  246. 11 May 13:33:14  Calling Mike's Place (444-3333).................. CONNECT ....
  247. 11 May 13:33:49  Bundle sent to 5210/2                                        :
  248. 11 May 13:33:53  Outgoing connect time: 0:13 (5210/2)                         :
  249.                  ................................................... END .....:
  250.  
  251.  
  252. 11 May 14:16:23  Calling NERD'S NOOK #1 Opu (333-2222)............ CONNECT ....
  253. 11 May 14:16:58  Flagging c:\00000208.mo3 as sent                             :
  254. 11 May 14:17:07  UL-S C:\0E110201.PKT                                         :
  255. 11 May 14:17:07  Bundle from 161/1                                            :
  256. 11 May 14:17:19  Unpacking sea bundle from 161/1                              :
  257. 11 May 14:17:21  2 messages                                                   :
  258.                  ................................................... END .....:
  259.  
  260.  
  261. 11 May 15:30:30  Calling FOG CITY OPUS (222-3333)................. CONNECT ....
  262. 11 May 15:32:18  Flagging c:\002401ff.mo7 as sent                             :
  263. 11 May 15:32:28  UL-S C:\0F20140D.PKT                                         :
  264. 11 May 15:32:28  Bundle from 125/10                                           :
  265. 11 May 15:36:40  UL-S C:\Ffdcfe01.Mo4                                         :
  266. 11 May 15:36:54  ARCE C:\*.MO?                                                :
  267. 11 May 15:37:06  Unlink C:\FFDCFE01.MO4                                       :
  268. 11 May 15:37:07  Unpacking oMMM bundle from 125/10                            :
  269. 11 May 15:37:08  Unpacking oMMM bundle from 125/10                            :
  270. 11 May 15:38:12  52 messages                                                  :
  271.                  ................................................... END .....:
  272.  
  273.  
  274. 11 May 16:11:25  Calling Mike's Place (333-4444)
  275. 11 May 16:26:58  Calling Mike's Place (333-4444)
  276. 11 May 16:32:38  Calling Mike's Place (333-4444).................. CONNECT ....
  277. 11 May 16:33:14  Bundle sent to 5210/2                                        :
  278. 11 May 16:33:18  Outgoing connect time: 0:13 (5210/2)                         :
  279.                  ................................................... END .....:
  280.  
  281.                    :
  282.                    :
  283.                   etc.
  284.                    :
  285.                    :
  286.  
  287. ------------------------------------------------------------------------------
  288. Lines Scanned:  1120                                    End of Summary
  289. ==============================================================================
  290.  
  291.  
  292. Please  note  that  all  outgoing calls are recorded  whether  or  not  a
  293. connection is made.   If a connection is made it will be identified  with
  294. the  seperator  lines  and  the keyword  "CONNECT".    The  end  of  that
  295. connection will likewise be marked as in the example.  This allows you to
  296. trace ALL outgoing call activity.
  297.  
  298. In  addition,   all  activity and exchanges which took place  during  the
  299. connection will be recorded.
  300.  
  301. If the command line switch -OC is use,  OPUS!LOG will also calculate  the
  302. cost  of  the call based upon the information contained in  NODELIST.BBS.
  303. This information will be appended after each completed call.  To use this
  304. function  the  file  NODELIST.BBS  MUST  BE  PRESENT  on  the  default
  305. drive/directory.
  306.  
  307.  
  308.  
  309.               3.04 - Incoming Matrix Traffic Summary Report
  310.  
  311.  
  312. This  report is similar to the preceeding one except that it  tracks  all
  313. incoming  matrix  activty.   Again,   it is simple  and  requires  little
  314. explanation:
  315.  
  316.  
  317.  
  318.                              Opus!Log - Ver. 2.2xn
  319.                (C) Copyright 1987, Satore Center Software, [SCS]
  320. ------------------------------------------------------------------------------
  321.                         Incoming Matrix Traffic Summary
  322. ------------------------------------------------------------------------------
  323.   Date    Time                      Commentary or Description
  324.  
  325. 11 May  7:08:09  Connect 2400 - Incoming Matrix
  326. 11 May  7:08:14  Session with Harv's Hideout - San Francisco (0:161/77.0)
  327. 11 May  7:08:19  UL-S C:\Private\07081011.PKT
  328. 11 May  7:08:19  Bundle from 161/77
  329. 11 May  7:09:50  UL-S C:\Private\0000fe44.Mo1
  330. 11 May  7:10:06  ARCE C:\Private\*.MO?
  331. 11 May  7:10:15  Unlink C:\Private\0000FE44.MO1
  332. 11 May  7:10:16  Unpacking oMMM bundle from 161/77
  333. 11 May  7:10:17  Unpacking oMMM bundle from 161/77
  334. 11 May  7:11:05  50 messages
  335.  
  336. 11 May  8:38:19  Connect 1200 - Incoming Matrix
  337. 11 May  8:38:24  TSYNC: Incoming LoTek
  338. 11 May  8:38:34  UL-S C:\Private\08261928.PKT
  339. 11 May  8:38:35  Bundle from 5210/2
  340. 11 May  8:38:47  Unpacking fido bundle from 5210/2
  341.  
  342. 11 May  9:16:44  Connect 1200 - Incoming Matrix
  343. 11 May  9:16:50  TSYNC: Incoming LoTek
  344. 11 May  9:17:01  UL-S C:\Private\09103301.PKT
  345. 11 May  9:17:01  Bundle from 5210/2
  346. 11 May  9:17:39  UL-S C:\Private\Dutchie.Cfg
  347. 11 May  9:17:48  Unpacking fido bundle from 5210/2
  348. 11 May  9:17:49  1 messages
  349.  
  350. 11 May  9:22:45  Connect 1200 - Incoming Matrix
  351. 11 May  9:22:50  TSYNC: Incoming LoTek
  352. 11 May  9:23:02  UL-S C:\Private\09163320.PKT
  353. 11 May  9:23:02  Bundle from 5210/2
  354. 11 May  9:23:10  File(s) not sent: No such file or directory
  355. 11 May  9:23:14  Unpacking fido bundle from 5210/2
  356. 11 May  9:23:16  1 messages
  357.                     :
  358.                    etc.
  359.                     :
  360. ------------------------------------------------------------------------------
  361. Lines Scanned:  1046                                    End of Summary
  362. ==============================================================================
  363.  
  364.  
  365. Please note that ALL activity which takes place throughout the connection
  366. is  recorded.   This includes any external processing which you may  have
  367. selected to manage incoming netmail or echomail.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                   3.05 - Log Warning Flag Summary Report
  374.  
  375.  
  376. The  OPUS  log  will automatically flag certain  activities  as  unusual.
  377. These are commonly referred to as "warnings".  This report summarizes all
  378. such  activity,  appending the name and date of the caller who  generated
  379. the warning entry:
  380.  
  381.  
  382.  
  383.  
  384.                              Opus!Log - Ver. 2.2xn
  385.                (C) Copyright 1987, Satore Center Software, [SCS]
  386. ------------------------------------------------------------------------------
  387.                             Log Warning Flag Summary
  388. ------------------------------------------------------------------------------
  389.   Date    Time                      Commentary or Description
  390.  
  391.  
  392. 11 MAY  8:27:17  RENE BILODEAU CALLING
  393. 11 May  8:27:25  Rene Bilodeau isn't in user list
  394.  
  395. 11 MAY  9:19:36  GEOFFREY MEREDITH CALLING
  396. 11 May  9:22:22  Modem doesn't report `OK'
  397.  
  398. 11 MAY  9:28:59  CINDY MCCREADY CALLING
  399. 11 May  9:34:09  Baud rate??
  400. 11 May  9:34:09  Request D=0
  401.  
  402. 11 MAY 16:53:58  BRIAN RODRUCK CALLING
  403. 11 May 16:53:59  Bad Pwd `Bkr'
  404.                    :
  405.                    :
  406.                   etc.
  407.                    :
  408.                    :
  409. ------------------------------------------------------------------------------
  410. Lines Scanned:  1120                                    End of Summary
  411. ==============================================================================
  412.  
  413.  
  414. Please  refer  to  your OPUS documentation for a further  description  of
  415. these various warning messages.
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                    3.07 - Message Area Activity Summary
  422.  
  423.  
  424. For those Sysops who like to see a summary of local message traffic, here
  425. is the report you will need:
  426.  
  427.  
  428.  
  429.                              Opus!Log - Ver. 2.2xn
  430.                (C) Copyright 1987, Satore Center Software, [SCS]
  431. ------------------------------------------------------------------------------
  432.                          Message Area Activity Summary
  433. ------------------------------------------------------------------------------
  434.   Date    Time                      Commentary or Description
  435.  
  436. 11 May  8:27:17  Rene Bilodeau          Msg to All, area 2, #36
  437. 11 May  9:24:55  Mike Kelleher          Msg to Mike, area 11, #3
  438. 11 May  9:24:55  Mike Kelleher          Matrix charge 25
  439. 11 May  9:43:39  Jan Gyn                Msg to Cindy Mccready, area 1, #84
  440. 11 May  9:55:27  Josh Gordon            Msg to Cindy or Mike, area 0, #85
  441. 11 May 11:10:13  Ted Decastro           Msg to Cindy or Mike, area 1, #86
  442. 11 May 11:10:13  Ted Decastro           Msg to Cindy or Mike, area 1, #87
  443. 11 May 11:10:13  Ted Decastro           Msg to Cindy or Mike, area 1, #88
  444. 11 May 13:04:51  Cindy Mccready         Msg to Jan Gyn, area 1, #89
  445. 11 May 13:04:51  Cindy Mccready         Msg to Mike Kelleher, area 11, #4
  446. 11 May 13:04:51  Cindy Mccready         Matrix charge 25
  447. 11 May 13:04:51  Cindy Mccready         Msg to Josh Gordon, area 1, #90
  448. 11 May 13:04:51  Cindy Mccready         Msg to Ted Decastro, area 1, #91
  449. 11 May 15:52:37  Cindy Mccready         Msg to Mike Kelleher, area 11, #8
  450. 11 May 15:52:37  Cindy Mccready         Matrix charge 25
  451. 11 May 16:12:22  Todd Fasnacht          Msg to Mike Kelleher, area 2, #37
  452. 11 May 16:12:22  Todd Fasnacht          Msg to Mike Kelleher, area 2, #38
  453. 11 May 16:12:22  Todd Fasnacht          Msg to Bill Obrien, area 2, #39
  454. 11 May 16:12:22  Todd Fasnacht          Msg to Harold Choate, area 2, #40
  455. 11 May 16:53:58  Brian Rodruck          Msg to Ted Glenwright, area 2, #41
  456. 11 May 16:53:58  Brian Rodruck          Msg to Ted Glenwright, area 2, #42
  457.                    :
  458.                    :
  459.                   etc.
  460.                    :
  461.                    :
  462. ------------------------------------------------------------------------------
  463. Lines Scanned:  1120                                    End of Summary
  464. ==============================================================================
  465.  
  466.  
  467. Notice that two activities are identified:   any individual who leaves  a
  468. message  and  any activity which results in a matrix charge to the  users
  469. account.
  470.  
  471. Note:   Since version 2.2x,  this report has been expanded and  contains
  472. much more information than in the example given above.
  473.  
  474.  
  475.  
  476.  
  477.  
  478.                 3.08 - Log File/Message Area Tracer Report
  479.  
  480.  
  481. A  very  simple report which traces any change in message  or  file  area
  482. undertaken by a user:
  483.  
  484.  
  485.  
  486.  
  487.                              Opus!Log - Ver. 2.2xn
  488.                (C) Copyright 1987, Satore Center Software, [SCS]
  489. ------------------------------------------------------------------------------
  490.                           Log File/Message Area Tracer
  491. ------------------------------------------------------------------------------
  492.   Date    Time                      Commentary or Description
  493.  
  494. 11 May  6:35:27  Lee Fields             File area 2 Cereal
  495. 11 May  6:35:27  Lee Fields             File area 1 Openfile
  496. 11 May  6:35:27  Lee Fields             File area 4 Applicat
  497. 11 May  6:35:27  Lee Fields             File area 5 Upload
  498. 11 May  6:35:27  Lee Fields             File area 6 Commerci
  499. 11 May  6:35:27  Lee Fields             Msg.area 1 General
  500. 11 May  6:35:27  Lee Fields             Msg.area 2 Opusmsg
  501. 11 May  7:03:33  Mike Lennig            File area 3 Rebarb
  502. 11 May  7:03:33  Mike Lennig            File area 5 Upload
  503. 11 May  7:25:39  David Coe              File area 2 Cereal
  504. 11 May  7:25:39  David Coe              Msg.area 1 General
  505. 11 May  7:25:39  David Coe              File area 6 Commerci
  506. 11 May  8:08:30  Justin Marquez         File area 1 Openfile
  507. 11 May  8:27:17  Rene Bilodeau          Msg.area 2 Opusmsg
  508. 11 May  8:56:12  Bill Macneill          Msg.area 2 Opusmsg
  509. 11 May  8:56:12  Bill Macneill          File area 2 Cereal
  510. 11 May  9:19:36  Geoffrey Meredith      File area 1 Openfile
  511. 11 May  9:43:39  Jan Gyn                Msg.area 4 Tech
  512. 11 May 10:29:45  Dave Giunti            Msg.area 4 Tech
  513. 11 May 10:29:45  Dave Giunti            Msg.area 6 C_Echo
  514. 11 May 10:29:45  Dave Giunti            Msg.area 7 Comm
  515. 11 May 10:29:45  Dave Giunti            Msg.area 1 General
  516. 11 May 10:29:45  Dave Giunti            Msg.area 2 Opusmsg
  517. 11 May 10:29:45  Dave Giunti            File area 6 Commerci
  518. 11 May 10:29:45  Dave Giunti            File area 1 Openfile
  519. 11 May 15:04:01  Gary Rux               File area 2 Cereal
  520. 11 May 15:04:01  Gary Rux               File area 1 Openfile
  521. 11 May 15:04:01  Gary Rux               File area 3 Rebarb
  522. 11 May 15:04:01  Gary Rux               File area 4 Applicat
  523. 11 May 15:04:01  Gary Rux               File area 5 Upload
  524. 11 May 15:04:01  Gary Rux               File area 3 Rebarb
  525. 11 May 15:04:01  Gary Rux               File area 1 Openfile
  526.                   :
  527.                  etc.
  528.                   :
  529.  
  530. This  report will allow you to trace the activity in various message  and
  531. file areas as well as specific user activity.
  532.  
  533. Note:   As with the previous report,  since version 2.2x of OPUS!LOG was
  534. released, the contents of this report have been significantly expanded.
  535.  
  536.  
  537.  
  538.  
  539.                   4.00 - The Statistical Summary Report
  540.  
  541.  
  542. Opus!log  also  provides a statistical summary report which is  available
  543. as a separate report.    You are  able to pipe this report to an external
  544. file or the printer as with any of the foregoing reports.
  545.  
  546. The  statistical  summary  report includes information on  the  following
  547. categories of information:
  548.  
  549.  
  550.                               Incoming Calls
  551.                               Outoing Calls
  552.                                   Events
  553.                           Files/Packets Uploaded
  554.                          Files/Packets Downloaded
  555.                        Packets Received in NetMail
  556.                       Unsuccessful Polling Attempts
  557.                               Warning Lines
  558.                           Human Callers (count)
  559.                        Message Received in NetMail
  560.                                  Connects
  561.                      300/1200/2400/9600 Baud Connects
  562.                           Length of Average Call
  563.                             Total Hours Online
  564.                               Matrix Callers
  565.                               Local Messages
  566.                             Log Lines Surveyed
  567.  
  568.  
  569.  
  570.  
  571.  
  572.                       5.00 - User Definable Reports
  573.  
  574.  
  575. Opus!Log also allows you to design any number of customized reports which
  576. may  be  run in addition to the standard reports already described.    In
  577. order to make use of this feature you must create a special ASCII control
  578. file  with the name OPUS!LOG.RPT.   This control file must be located  in
  579. the same directory as Opus!log itself (see section 6.00 - Installation).
  580.  
  581. The control file must contain the following information:
  582.  
  583.      Number of lines to be printed PRIOR to the target line (numeric)
  584.       Number of lines to be printed AFTER the target line (numberic)
  585.                        Target line text (a string)
  586.                         Title of Report (a string)
  587.  
  588. NONE  OF  THIS INFORMATION IS OPTIONAL.   Your control file  must  always
  589. contain these four pieces of information.
  590.  
  591. Suppose,  as an example, we wanted to find every log line which contained
  592. the  string  "UL-".   This would indicate that some file/packet has  been
  593. uploaded.    Further  suppose  that we would like to see the  five  lines
  594. preceeding  the  target line and the three lines after the  target  line.
  595. Finally, we will call the report "UPLOAD REPORT".  Here is the line which
  596. should be contained in the control file:
  597.  
  598.                           5,3,UL-,UPLOAD REPORT
  599.  
  600. Please note that the string items DO NOT require quotes.  If we wished to
  601. ONLY see the line containing the target string we would change the  first
  602. two elements to zero like this:
  603.  
  604.                           0,0,UL-,UPLOAD REPORT
  605.  
  606. You  may  have  as many special report lines as you like in  the  control
  607. file. There is no limitation but your imagination.
  608.  
  609. Please  see Section 7.00  for an example of using this,  and  the  other,
  610. Opus!log options.
  611.  
  612.  
  613.  
  614.                            6.00 - Installation
  615.  
  616.  
  617. The  Opus!log executable file should reside in the same directory as your
  618. OPUS  log  file.    If you choose to use the  customized  report  options
  619. mentioned  in Section 5.00,  your control file should be located  in  the
  620. same directory. The control file MUST be named OPUS!LOG.RPT.
  621.  
  622. Opus!Log has been designed to run fully unattended in BATch file mode for
  623. regular processing.  It has also been designed to drop back to DOS should
  624. it  encounter  any  unknown  error.    It is  therefore  usable  in  your
  625. RUNBBS.BAT (or whatever) OPUS file for daily processing of your log.
  626.  
  627.  
  628.  
  629.  
  630.  
  631.                          7.00 - Running Opus!Log
  632.  
  633.  
  634. Opus!Log runs in a variety of different modes.
  635.  
  636. First  of  all  it is assumed that your OPUS log  file  is  named  either
  637. OPUS.LOG or SYSOP.LOG.  If not, please see section 7.10 - Declaring a Log
  638. File  Name.   By using a log file name of SYSOP.LOG or OPUS.LOG you  will
  639. automatically activate the Opus!Log default features (fixed format report
  640. series).    With another log file name you must specify which reports are
  641. desired (as discussed below).
  642.  
  643. Each of the fixed format reports has a special command line switch.   You
  644. may  declare  any combination of reports by including it's  command  line
  645. switch as appropriate.  You many mix and match any number of valid report
  646. command  line  switches.
  647.  
  648. Here are the command line switches for the fixed format reports:
  649.  
  650.        -t ..... File and Packet Exchange Summary Report
  651.       -tf ..... Same as -T but also create output file list
  652.                 (creates OLOG.TXT on default drive/directory)
  653.        -h ..... Human Caller Summary Report
  654.        -o ..... Outgoing Calls Summary Report
  655.       -oc ..... Same as -O but also show cost per call data
  656.                 (requires NODELIST.BBS on default drive/directory)
  657.        -i ..... Incoming Matrix Traffic Summary Report
  658.        -w ..... Log Warning Flag Summary Report
  659.        -m ..... Message Area Activity Summary
  660.        -n ..... Show NetMail activity only (-I-O)
  661.        -x ..... Log File/Message Area Tracer
  662.      -all ..... Run all fixed format reports (except -TF and -OC)
  663.  
  664.  
  665. In  addition,   there  are two other command line  switches  for  special
  666. reports which MAY NOT BE MIXED with the fixed format report switches.
  667.  
  668.      -special ..... Invoke the user definable report sequence using
  669.                     the control file Opus!Log.RPT
  670.  
  671.      -stats   ..... Invoke the video statistical summary
  672.  
  673. These two switches are also mutually exclusive.  In other words,  you may
  674. mix  any  or all of the fixed format report switches,   however,  the  "-
  675. special"  and  "-stats"   switchs must ALWAYS stand alone  when  invoking
  676. Opus!Log.
  677.  
  678. Here are some example to make this a little easier:
  679.  
  680.      To invoke the statistical summary:        Opus!Log -stats
  681.      To invoke your customized reports:        Opus!Log -special
  682.      To see upload/download report    :        Opus!Log -t
  683.      To run all fixed format reports  :        Opus!Log -all
  684.  
  685. Here's  an  example to see ALL the various reports and pipe them to  your
  686. printer:
  687.  
  688.                      Opus!log -t-h-o-i-w-e-m-x > prn
  689.  
  690. HOWEVER...  if your Opus log is named OPUS.LOG or SYSOP.LOG and you would
  691. like to see ALL of the reports you can simply enter this:
  692.  
  693.                            Opus!Log -all > prn
  694.  
  695. This  will have the same effect as the previous example.   Remember  that
  696. the default mode of Opus!Log is:
  697.  
  698.                 ...  log file name of OPUS.LOG or SYSOP.LOG
  699.  
  700. Also it is imporant to note that the reports will ALWAYS be displayed  on
  701. your video,  even when you are using the DOS pipe option to a file or the
  702. printer.
  703.  
  704. Should you have difficulty remembering any of this, simply enter:
  705.  
  706.             Opus!log   or   Opus!Log -help   or   Opus!log -?
  707.  
  708. and  a  short help screen will be displayed.   You may enter any  command
  709. line parameter in either upper or lower case.
  710.  
  711.  
  712.  
  713.  
  714.                      7.10  Declaring a Log File Name
  715.  
  716.  
  717. Should  you use a log file name other than OPUS.LOG or SYSOP.LOG you  can
  718. still  use  Opus!Log;  however,  the default  conditions  are  therefore
  719. overridden and you MUST declare each report you would like on the command
  720. line.  The command line format is:
  721.  
  722.                 Opus!Log [logfilename] [report switches]
  723.                 Opus!Log [logfilename] [special switches]
  724.  
  725. It is expected that most Sysops will use one of the two default log  file
  726. names  and  therefore  this  option  has  only  been  provided  for  the
  727. exceptional case.
  728.  
  729.  
  730.  
  731. 8.00  Summary
  732.       -------
  733.  
  734. Use  Opus!Log  in good health.   Please send your comment/suggestions  to
  735. Satore Center, 161/521 in the Matrix.
  736.  
  737. Please consider a contribution if you like and use the program...
  738.  
  739.  
  740.  
  741. 9.00  Credits and Revision History
  742.       ----------------------------
  743.  
  744. Thanks to Harvey Nehgila for banging and suggesting.
  745.  
  746. Version 1.00 - 1.97   Extreme testing and bug stomping
  747. Version 1.98          Beta
  748. Version 2.00          First Release (limited)
  749. Version 2.2x          A series of updates to keep up with the changing
  750.                       log format of OPUS.  A number of improvements were
  751.                       added, including upgrading the -M and -X reports,
  752.                       adding the cost option (-OC) and output file report
  753.                       for transferred files (-TF).
  754. Version 2.3x          Brought up to date for OPUS 1.01
  755. Version 2.3x          Scripting recognition added
  756. Version 2.4x          Added report -g switch for online summary
  757. Version 2.4x          First public release
  758.